Repository navigation
docs(mcp): fix stale tool lists and counts in docs, marketing, and SDK reference - #6029
Conversation
…K reference The docs capabilities table omitted Agents and Terminals entirely, the terminals tool table listed 1 of 5 tools, marketing llms.ts claimed 27 tools (actual: 31), and the SDK api.md documented only terminals.create despite the resource shipping all five methods. Claude-Session: https://claude.ai/code/session_01Kub4p3Eim9pc1qaRRmGea2
|
Ready to review this PR? Stage has broken it down into 3 individual chapters for you:
Chapters generated by Stage for commit 3950b1a on Jul 28, 2026 10:14pm UTC. |
📝 WalkthroughWalkthroughMCP documentation now lists agent and terminal capabilities, the SDK API reference documents terminal session operations, and marketing copy points to the full MCP server catalog. ChangesMCP documentation
Estimated code review effort: 1 (Trivial) | ~5 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@apps/marketing/src/lib/llms.ts`:
- Line 56: Update the MCP server description in the marketing category list to
include the documented Organization capability, or revise the wording to
explicitly indicate the tools list is non-exhaustive while preserving the
existing description.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro Plus
Run ID: 74da554a-8667-4fe6-bccc-bd8d61ab1099
📒 Files selected for processing (3)
apps/docs/content/docs/mcp-server.mdxapps/marketing/src/lib/llms.tspackages/sdk/api.md
| `- [API docs](${docsUrl}/mcp-server): Superset MCP server documentation`, | ||
| `- [OpenAPI spec](${API_URL}/openapi.json): OpenAPI 3.1 description of the Superset API surface`, | ||
| `- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — 27 tools for tasks, workspaces, agents, automations, terminals, hosts, and projects. Alias: ${API_URL}/mcp`, | ||
| `- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`, |
There was a problem hiding this comment.
🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win
Keep the marketing category list aligned with the MCP documentation.
Line 56 omits the Organization capability, which is documented in apps/docs/content/docs/mcp-server.mdx at Line 25. Add organization to this list, or make the wording explicitly non-exhaustive (for example, “including tools for…”).
Suggested fix
- `- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,
+ `- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, projects, and organization; full catalog in the server card. Alias: ${API_URL}/mcp`,📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| `- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`, | |
| `- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, projects, and organization; full catalog in the server card. Alias: ${API_URL}/mcp`, |
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@apps/marketing/src/lib/llms.ts` at line 56, Update the MCP server description
in the marketing category list to include the documented Organization
capability, or revise the wording to explicitly indicate the tools list is
non-exhaustive while preserving the existing description.
🧹 Preview Cleanup CompleteThe following preview resources have been cleaned up:
Thank you for your contribution! 🎉 |
Part of the MCP v2 rework (Phase 0a).
apps/docsmcp-server.mdx: capabilities table gains the missing Agents and Terminals rows; terminals tool table now lists all 5 tools (was onlyterminals_create).apps/marketingllms.ts: drops the hardcoded "27 tools" (actual count is 31, and it will change again during the toolset rework) — points at the self-updating server card instead.packages/sdkapi.md: documents all fiveclient.terminals.*methods and their types (onlycreatewas listed; the resource has shipped list/send/read/close for a while).Docs-only, no behavior change.
https://claude.ai/code/session_01Kub4p3Eim9pc1qaRRmGea2
Summary by cubic
Fixes stale MCP tool lists across docs, marketing, and SDK. Adds Agents/Terminals to capabilities, lists all terminal tools, documents
client.terminals.{create,list,send,read,close}, and replaces the hardcoded tool count with the self-updating server card.Docs-only; no behavior changes.
Written for commit 3950b1a. Summary will update on new commits.
Summary by CodeRabbit